home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
BBS Toolkit
/
BBS Toolkit.iso
/
programs
/
lastcl10.zip
/
LASTCALL.DOC
< prev
next >
Wrap
Text File
|
1993-01-11
|
9KB
|
200 lines
---------------------------------------------------------------------------
LastCallers v1.0 Copyright (c) 1993 by Bryan J. Nylin
Written and compiled in QuickBASIC v4.5
---------------------------------------------------------------------------
LastCallers v1.0 is a utility designed for TriBBS sysops to create a
bulletin showing the latest users to call the BBS. It is compatible
with TriBBS v3.3 - No other versions have been tested.
This software is SHAREWARE. You are granted permission to distribute
the LASTCL10 archive freely, provided all the original files are kept
together, and only a nominal fee is charged. The files in this archive
should be:
LASTCALL.DOC This documentation file.
LASTCALL.REG Registration/order form
LASTCALL.EXE Executable program.
LASTCALL.CFG Configuration file
FILE_ID.DIZ Program description for BBS posting.
The result of McAffee's VALIDATE program on LASTCALL.EXE is as follows:
File Name: LASTCALL.EXE
Size: 52,698
Date: 1-10-1992
File Authentication:
Check Method 1 - B45B
Check Method 2 - 0EBD
If any of these numbers do not match, you have an invalid archive that
might be infected with a virus. Delete the archive and contact the
person or BBS you received it from.
This SHAREWARE program is distributed with the concept that if you find
it useful and continue to use it beyond a 30-day free trial period, you
must send in the $10 registration fee (discounts available when registering
multiple copies and/or additional utilities at the same time).
To help you evaluate the program, no features have been left out of this
shareware release. See the file LASTCALL.REG for the order form.
INSTALLATION INSTRUCTIONS:
-------------------------------------------------------------------------
Step 1. Extract the files from the distribution archive into
your BBS utilities directory. (I use \BBS\UTIL)
Step 2. Make your utilities directory the default (CD \BBS\UTIL)
Step 3. Edit LASTCALL.CFG to match your system configuration.
Each line is documented in a section below.
Step 4. Run LASTCALL with the /R parameter to reset the datafile.
This will create LASTCALL.DAT in your utilities directory.
Step 5. Edit your TriBBS BETWEEN.BAT file to include LASTCALL.
Example:
---------->File starts Here<-------------
cd\bbs\util
LASTCALL /L /E=999
cd\bbs\tribbs
---------->File ends Here<-----------------
Step 6. You are done! The next time a caller logs off and
BETWEEN.BAT is executed, the bulletin is updated.
CONFIGURATION FILE
-------------------------------------------------------------------------
The sample file LASTCALL.CFG included in this archive looks like this:
---------->File starts Here<-------------
bbs=Jet City Connection
log=J:\BBS\TRIBBS\MWORK\CALLERS.LOG
dir=J:\BBS\TRIBBS
max=15
ansi=J:\BBS\tribbs\display\BULLET5.ANS
ascii=J:\BBS\tribbs\display\BULLET5.BBS
---------->File ends Here<-----------------
Each line starts with a TAG and an equal sign. These must be typed
correctly in order for the LASTCALL program to recognize them. It is
not case sensitive, however. Each tag is explained as follows:
bbs= Name of the BBS you want to appear at top of bulletin.
log= File name of caller log to read. LASTCALL looks only at
the last caller in the log file.
dir= Main TriBBS directory (Node 1).
max= Maximum number of lines to print in the bulletin. A
'15' here would indicate to only print the last 15
callers.
ansi= File name and path of the ANSI bulletin to create.
ascii= File name and path of the ASCII bulletin to create.
COMMAND LINE PARAMETERS:
--------------------------------------------------------------------------
Usage: LASTCALL [/F] [/R] [/L] [/E=nnn] [/?] [/HELP]
Where: /F Forces bulletin output even if last caller was not new.
/R Resets datafile
/L Includes local logons
/E=nnn Excludes callers at or above security level nnn.
Explanation:
/F Normally, the program only generates the bulletin when
the last caller was a new user. This switch will force
the output regardless of that fact.
/R This switch will cause LASTCALL.DAT to be cleared out
before looking at the log file.
/L Includes local logons. By default local logons are
ignored and not recorded.
/E=nnn Excludes any caller with a security level at or above
'nnn'. Useful to exclude sysop from list when calling
from remote line.
EXAMPLE: NEWUSERS /L /E=999
Includes local logons, but excludes any users at level 999
(or above). Handy if there are users other than the sysop
that log on locally that should be on the list. Also
keeps a sysop from being recorded when calling by modem.
LASTCALL.DAT Layout
--------------------------------------------------------------------------
This is a straight forward ASCII file. It was programmed this way for
easy access by the sysop in case it is necessary to edit out a name from
the last caller list. Generally speaking, you can delete records from this
file without causing any problems, any empty space will be taken up the
next time LASTCALL runs. You must BE CAREFUL TO DELETE WHOLE RECORDS.
One record consists of:
Line 1 John Doe User Name
Line 2 01/08/92 Date of first call
Line 3 2400 Baud rate
Line 4 Nowhere, WA City, State
Line 5 21:01 Time On
Line 6 21:30 Time Off
Line 7 - Dropped Carrier ('-'=d/c, ' '=no)
Line 8 1 Node #
Empty records are stored as "Empty, 00/00/00, 0, etc." and are easily
identifiable. If you add or delete from this file, make sure you work
with a GROUP OF 8 LINES ONLY. If you don't, odd results will happen and
you will probably have to run LASTCALL /R to reset the datafile.
Notice the '-' dropped carrier flag. This is a little obscure, but this
character prints directly after the baud rate when the caller dropped
carrier. Since this is not something users generally concern themselves
with, and the amount of data was already pretty jammed, this seemed
sufficient. A sysop can look at the list and see who dropped carrier
very easily (a '2400-' is one that dropped carrier, '2400' was fine).
If you happen to edit Line 7, it should either have a '-' or a space.
If the line is empty or has several blanks the report format will be off.
DESCRIPTION OF OPERATION
--------------------------------------------------------------------------
LASTCALL will open the LASTCALL.DAT file and add all the information
into the DAT file for the last caller. It also opens the USERS.DAT file
in the Node 1 MWORK directory to get the City, State where the caller
is from and their call number. If the number of records in LASTCALL.DAT
exceeds that specified by the "max=" tag in LASTCALL.CFG, the oldest
record will be scrolled off the list.
--------------------------------------------------------------------------
Support questions can be left, and latest version downloaded
from the author's BBS near Seattle, WA:
Jet City Connection BBS, (206)839-8843, v.32bis, Fido 1:343/140
Messages can also be addressed to Bryan Nylin at:
FidoNet 1:343/140
CompuServe 71441,1420
---------------------------------------------------------------------------
This SHAREWARE program is distributed with the concept that if you find
it useful and continue to use it beyond a 30-day free trial period, you
must send in the $10 registration fee (discounts available when registering
multiple copies and/or additional utilities at the same time).
To help you evaluate the program, no features have been left out of this
shareware release. See the file LASTCALL.REG for the order form.
---------------------------------------------------------------------------